.TH E1432_SET_CALIN 3 E1432
.SH NAME
.nf
e1432_set_calin \- Set driver for the CALIN line
e1432_get_calin \- Get current value of CALIN driver
.fi
.IX e1432_set_calin(3) 3
.IX e1432_get_calin(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_calin(E1432ID hw, SHORTSIZ16 ID,
                           SHORTSIZ16 calin)
SHORTSIZ16 e1432_get_calin(E1432ID hw, SHORTSIZ16 ID,
                           SHORTSIZ16 *calin)
.cE
.SH DESCRIPTION
\fIe1432_set_calin\fR sets the driver for the internal CALIN line, of
a single channel or group of channels \fIID\fR, to the value given in
\fIcalin\fR.  The CALIN line is sent to all SCAs, the optional source
board, and the break-out box.

\fIe1432_get_calin\fR returns the current setting of the internal
calibration DAC, of a single channel or group of channels \fIID\fR,
into a memory location pointed to by \fIcalin\fR.

This parameter is a "global" parameter.  It applies to an entire E1432
module rather than to one of its channels.  The \fIID\fR parameter is
used only to identify which module the function applies to, and all
channels in that module will report the same value for this parameter.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR, or the ID of a single channel.

\fIcalin\fR determines the driver for the CALIN line.  This should be
one of:

\fBE1432_CALIN_OPEN\fR, to have nothing drive the line.

\fBE1432_CALIN_GROUND\fR, to ground the line.

\fBE1432_CALIN_DC_HI\fR, to have the calibration DAC high range drive
the line (the DAC can then drive between +-15 volts).

\fBE1432_CALIN_DC_LO\fR, to have the calibration DAC low range drive
the line (the DAC can then drive between +-0.48 volts).

\fBE1432_CALIN_SUMBUS\fR, to have the VXI SUMBUS, amplified by a
factor of 3, drive the line.

\fBE1432_CALIN_SUMBUS_TACH\fR, which is identical to
\fBE1432_CALIN_SUMBUS\fR, except that it indicates that the SUMBUS is
being driven by an E1432 tach channel.  This can be used when
monitoring an E1432 tach channel, and is a hint to the input channel
that the scale factor should be adjusted properly for the tach board.
See \fIe1432_set_input_high\fR for more information on monitoring tach
channels.

\fBE1432_CALIN_CALOUT\fR, to have the internal CALOUT line drive the
line.  The CALOUT line can be driven by the optional source board, or
by the option tach board.  When monitoring tach channels,
\fBE1432_CALIN_CALOUT\fR is a more direct connection to the input
channels, and will result in smaller DC offset.  However, it works
only within a single E1432 module.
.SH "RESET VALUE"
After a reset, \fIcalin\fR is set to \fBE1432_CALIN_GROUND\fR.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_input_high, e1432_set_cal_voltage, e1432_set_source_output,
e1432_set_sumbus
.ad
